home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 8 / Power CD-ROM 8.iso / dos / ad / aciddraw.doc next >
Text File  |  1994-11-01  |  22KB  |  447 lines

  1.  
  2.                          ▄       ▄       ▄           ▄
  3.                           ▀█▄    ▐██▄▄  ██▄    ▄▄▄███▌
  4.                          ▄ ▐██   ████▀▀▄ █▀ ▄▀▀▄ ▀▀███▄
  5.                         █▌  ███ ▐███    ▄▄ ▀ ▄██    ▐███
  6.                        ██▀▀▀▐██▌ ███▌   ▐███  ██▌    ████
  7.                       ███▌  ▐███ ▐███▄   ██▌  ▐██▄▄ ▐████▌
  8.                      ▐████▄▄ ▀▀▀▀  ▀▀▀▀▀▀ ▀▀ ▀▀▀█████████
  9.                       ▀█▀▀    D    R    A    W     ▀▀▀█▀
  10.  
  11.  
  12.                                      v0.5α
  13.                               Ansi Screen Editor
  14.                                    Coded By
  15.                            Skull Leader & Sinned Soul
  16.  
  17.  
  18.  
  19. ┌──────────────┐
  20. │ Introduction │
  21. └──────────────┘
  22.                                             
  23.       ACiDDraw is a utility for manipulating ansi and ascii text. It is based
  24.       upon Ian Davis's Thedraw (tm). Many of it's basic features, and their
  25.       orginization parallel Thedraw. In addition to these, however, it has 
  26.       many refined and added features. The authors of this utility have sought 
  27.       to include, within an efficient and tightly organized program, the most
  28.       useful tools for manipulating ansi and ascii text that could be 
  29.       conceived. The ideas of some of the most experienced artists in these 
  30.       areas have been implemented in everyway possible, to create, what we 
  31.       hope, is the most useful utility of this type to date. 
  32.  
  33.  
  34.  
  35. ┌─────────────────────┐                                                       
  36. │ System Requirements │                                                       
  37. └─────────────────────┘                                                       
  38.                                                                               
  39.      ■ 286 or above with an enhanced keyboard
  40.      ■ DOS v3.30 or higher.  (Not tested under Windows, or OS/2)
  41.      ■ 300k Free memory. (Approx. Depends on page lengths)
  42.      ■ CGA video card and monitor.
  43.      ■ MCGA video card and monitor for 50 line mode and VGA viewing.
  44.      ■ SVGA video card and monitor for Hi-Res viewing.
  45.      ■ Microsoft or compatable mouse.
  46.  
  47.  
  48. ┌────────────────────────┐
  49. │ Suggested Requirements │
  50. └────────────────────────┘
  51.  
  52.      ■ 640k Free memory. (depending on page size)
  53.      ■ SVGA video card, with VESA support.
  54.      ■ Mouse with a Microsoft compatible mouse driver.
  55.                
  56.  
  57. ┌──────────────┐
  58. │ New Features │
  59. └──────────────┘
  60.  
  61.  ACiDDraw v0.5α includes the following new features over ACiDDraw v0.1ß :
  62.  
  63.                     ■ Mouse support
  64.                     ■ Supports up to 1000 lines per page
  65.                     ■ Supports up to 160 columns per page
  66.                     ■ Quick Palette
  67.                     ■ Proper flipping of a block
  68.                     ■ Tab and tab setup
  69.                     ■ Multi-Page support
  70.                     ■ Hi-Res Vga viewing
  71.                     ■ Binary load and save
  72.  
  73.  
  74. ┌────────┐
  75. │ Notice │
  76. └────────┘
  77.  
  78.      This alpha version of ACiDDraw is being release to you as is.  All bugs
  79. should be reported to either Skull Leader or Sinned Soul.  The authors take
  80. no responsibility for lost work, or damaged equipment caused directly or
  81. indirectly by this program.  ACiDDraw cannot be modified in any way with
  82. out the written consent of either author.  Finally, the charging of monetary
  83. fees by any unauthorized party for the circulation or use of this utility
  84. is expressly forbidden.
  85.  
  86.  
  87. ┌────────────┐
  88. │ The Editor │
  89. └────────────┘
  90.  
  91.      The editor consists of either a 80x24 or 80x49 viewable area.  There are
  92. two pages available, the page sizes are user selectable, up to 1000 lines at
  93. 80 columns or 100 lines at 160 columns.  The following keys will allow you
  94. to maneuver the viewing window within the virtual pages.
  95.  
  96.  Arrow Keys          : This keys allow you to move the cursor to different
  97.                        positions around the viewable screen.  The program
  98.                        will scroll the window to allow you to view the
  99.                        entire virtual page.
  100.  
  101.  Page Up/Page Down   : These two keys are keys which will allow you to
  102.                        maneuver around the virtual screen quickly.
  103.                        It will move the screen either up a page, or
  104.                        down a page.
  105.  
  106.  Tab                 : This will position your cursor to a position
  107.                        preset by the tab configuration. (See tab setup)
  108.  
  109.  Shift-Tab           : This will position your cursor to the previous
  110.                        position set in the tab configuration. (See tab setup)
  111.  
  112.  Ctrl-Left           : This will shift anything on the right hand side of
  113.                        the cursor over to the left by one.  This affects the
  114.                        entire length of the virtual screen.
  115.  
  116.  Ctrl-Right          : This will shift anything on the right hand side of
  117.                        the cursor over to the right by one.  This affects
  118.                        the entire length of the virtual screen.
  119.  
  120.  Ctrl-Y              : This will move every line below the cursor up one,
  121.                        deleting the row below the cursor.
  122.  
  123.  Ctrl-I              : This will move every line below the cursor down one,
  124.                        deleting the very last row.
  125.  
  126.  F1-F10              : These keys will display special ascii characters,
  127.                        these ascii characters are preset in the program.
  128.                        The current character which will be display by press
  129.                        any one of these keys are listed on the top right
  130.                        corner of the screen.  There are 15 sets of these
  131.                        characters all preset, and each set can be selected.
  132.  
  133.  ALT-1 to 10         : This will change the set which is currently being used,
  134.                        sets 1 through to 10 can be selected using the ALT key.
  135.  
  136.  Ctrl-1 to 5         : This will allow you to select the current sets from
  137.                        11 through to 15.
  138.  
  139.  
  140.  ALT-C               : This command will prompt you if you want to clear
  141.                        the screen, if you agree it will proceed to
  142.                        clear the current page.
  143.  
  144.  ALT-E               : This command will allow you to switch between
  145.                        two possible pages.  Each page is separate from
  146.                        the other page, and is user selectable.
  147.  
  148.                 Note - You must select two pages from the option menu before
  149.                        the second page can be activated.  Each page can
  150.                        have a separate length and width.
  151.  
  152.      Numbers and alphanumerics can be displayed by pressing the corresponding
  153. key on the keyboard.  All shift combined with the numeric and alphanumeric
  154. are also valid entries.
  155.  
  156.  
  157. ┌────────────────┐
  158. │ Color Changing │
  159. └────────────────┘
  160.  
  161. The editor has the ability to select between 16 normal foreground
  162. colors, 16 blinking foreground colors, and 8 background colors.  All of
  163. these are preset and cannot be changed.  The current color determines what
  164. attribute the next character displayed will have.
  165.  
  166.  Escape             : This key will pull down the quick palette menu,
  167.  (Quick Palette)      which allows you to easily change colors with arrow
  168.                       keys.  The up and down arrows allow you to change
  169.                       the foreground colors.  The BB beside the foreground
  170.                       colors represents a blinking color.  The left and
  171.                       right arrows change the current background color.
  172.                       The mouse can also be used to select the colors from
  173.                       quick palette. (see section on mouse support) To
  174.                       select a color, place the cursor on top of the colors
  175.                       you want and press the left button.
  176.  
  177.  Ctrl-A             : This key will bring a menu which allows you to select
  178.                       which color you want.  All the colors are displayed, and
  179.                       both the foreground and background colors must be
  180.                       entered.
  181.  
  182.  Ctrl-Left          : This key will select the previous background color
  183.                       available.
  184.  
  185.  Ctrl-Right         : This key will select the next background color
  186.                       available.
  187.  
  188.  Ctrl-Up            : This key will selected the next foreground color
  189.                       available.
  190.  
  191.  Ctrl-Down          : This key will selected the previous foreground color
  192.                       available.
  193.  
  194.  Alt-U              : This key will change the current color to the one
  195.                       located just under the cursor position.
  196.  
  197.  
  198. ┌──────────────┐
  199. │ Viewing Keys │
  200. └──────────────┘
  201.  
  202.  ALT-M              : This key toggles between a 25 and a 50 line display.
  203.  (Line Toggle)        A 50 line display is only available with a VGA adapter.
  204.  
  205.  ALT-V              : This key allows you to view the current page in
  206.  (VGA Viewing)        a simulated VGA environment.  It will try to convert
  207.                       the characters which are in text mode into a graphics
  208.                       mode.  The resolution which it is first displayed
  209.                       is 320x200x256c. (Which is available to anybody with
  210.                       a MCGA or better video card)
  211.  
  212.         F1          : While viewing in the 320x200x256c mode, ACiDDraw has
  213.                       the ability to change to higher resolutions.  These
  214.                       higher resolutions are only available to people with
  215.                       a SVGA or Super Video Graphics Adapter.  This key
  216.                       will display the vga at 320x200x256c mode.
  217.  
  218.         F2          : This will change the resolution to a 640x480x256c mode,
  219.                       which is only available on a SVGA video card.  The
  220.                       video card is auto-detected.
  221.  
  222.         F3          : This will change the resolution to a 1024x768x256c
  223.                       mode, which is only available on a SVGA video card.
  224.                       The video card is auto-detected.
  225.  
  226.  
  227.    It is possible to view each page in VGA, by selecting the proper page
  228. in text mode, then using ALT-V to view it.  If the picture does not fit onto
  229. a single VGA screen, you will be able to scroll the VGA using the up and down
  230. arrow keys.
  231.  
  232. ┌────────────────┐
  233. │ Setup Commands │
  234. └────────────────┘
  235.  
  236.  ALT-T              : This key combination will allow you to edit the position
  237.  (Tab Setup)          at which the cursor is placed when a TAB or Shift-Tab
  238.                       is placed.  Each marker is a place where the cursor
  239.                       jump, the cursor will jump to the next marker from
  240.                       its current position.  You can either set each tab
  241.                       location, or you can set the interval at which
  242.                       a marker is placed.
  243.  
  244.  ALT-O              : This is the main configuration for the program.
  245.  (Configuration)      These options are pretty much self-explanatory.
  246.                       If you want to keep your configuration for the
  247.                       next time you load ACiDDraw, you MUST type "S" to
  248.                       save the configuration to disk.
  249.  
  250.  
  251.      The number of pages can only be either 1 or 2.  With a page width of
  252. 160, only a length of up to 100 is available.  Two pages at 160x1000 lines
  253. each is not possible in this configuration since it would require over 640k.
  254.  
  255. IMPORTANT - For this version, you MUST exit the program and re-enter it
  256.             before the page sizes and numbering are re-initialized.
  257.  
  258.  
  259. ┌─────────────────────┐
  260. │ Additional Commands │
  261. └─────────────────────┘
  262.  
  263.  ALT-S              : This is the key combination to save an ansi.
  264.  (Save Ansi)          The following save methods are available
  265.                       ANSI :  Standard method for storing graphics in text
  266.                               mode.  The length of the ansi is automatically
  267.                               detected on the first blank line.  The
  268.                               characters per line option determine how many
  269.                               characters there will be before a carriage
  270.                               return.  An extension of .ANS is automatically
  271.                               placed onto a file with no extension.
  272.                      ASCII :  This method uses all the ascii characters, but
  273.                               without ansi color and movement codes.  The
  274.                               line length is also auto-detected.
  275.                     BINARY :  This is a raw binary dump of the entire virtual
  276.                               screen.  No length and width data is mentioned
  277.                               in the file.  You must use sauce to determine
  278.                               these.
  279.  
  280.      If a file is replacing an old one, the old file will automatically
  281. be rename with a .BAK extension.
  282.  
  283.  ALT-L             : This is the load menu, it is allows you to choose which
  284.  (Load Ansi)         file you want to load.  Any file with the extension
  285.                      of .BIN is loaded with a binary format, any other file
  286.                      is treated as an ansi file.
  287.  
  288.  ALT-D             : This menu will allow you to choose whether or not
  289.  (Sauce Description) SAUCE will be attached to the end of the file.
  290.                      It will also allow you to choose a name, group and title
  291.                      for your work.  The date, size, dimensions, etc. are
  292.                      are automatically updated for you when you save.
  293.  
  294.  
  295.  ALT-R             : This command will restore a backed up file onto the
  296.                      screen.  Before a BLOCK, VGA View, Load, a binary
  297.                      backup of the current screen is dumped to disk.  If
  298.                      you want to restore the screen before these commands,
  299.                      you can use this command to restore it.  (NOTE-this
  300.                      command is just in a testing stage, and is not meant
  301.                      to replace a genuine restore command)
  302.  
  303.                 Note-This temporary file is called _ADBACK_.$$$ and is
  304.                      deleted after ever normal exit from ACiDDRAW.  If there
  305.                      was a problem and ACiDDraw exited abnormally, before you
  306.                      were able to save your work, this backup file should
  307.                      be rename to .BIN and loaded from ACiDDraw.  Since
  308.                      only certain commands will update to this backup file,
  309.                      some work may not appear in the back up file.
  310.  
  311.  ALT-B             : This allows you to select a block and perform functions
  312.                      on this selected area of screen.  After blocking
  313.                      a certain area certain optional are available.
  314.  
  315.                      Copy or Move : Copy allows you to stamp a block multiple
  316.                                     times onto the screen, Block moves the
  317.                                     blocked area to a new location.
  318.  
  319.                      Flip X/V     : This flips the block horizontally,
  320.                                     "X" being a regular byte for byte flip,
  321.                                     while a "V" will flip any ascii characters
  322.                                     which have a horizonal mirror image.
  323.  
  324.                      Flip Y/W     : This flips the block vertically,
  325.                                     "Y" being a regular byte for byte flip,
  326.                                     while a "W" will flip any ascii characters
  327.                                     which have a vertical mirror image.
  328.  
  329.                      Fill         : Allows you to fill a blocked area
  330.                                     with either the current foreground,
  331.                                     background, both, or fill the blocked
  332.                                     area with a selected character, with or
  333.                                     without the current attribute.
  334.  
  335.  
  336.                      Page         : Allows you to paste your block onto a
  337.                                     separate page, (if another one is
  338.                                     available)
  339.  
  340.                      Outline      : Allows you to outline a blocked area
  341.                                     with a single, double, or a mix.
  342.                                     The selected set determines which is
  343.                                     drawn, set 1 single line, set 2 double
  344.                                     set 3 mix, set 4 mix.  The color of the
  345.                                     outline is determined by the current
  346.                                     drawing color.  
  347.  
  348.                      Save         : Allows you to save a block, using
  349.                                     either the ANSI, ASCII or BINARY method.
  350.  
  351.  ALT-H              : A multi-screen help menu can be called up using this
  352.                       key combination.  Inside summarizes most of the
  353.                       commands.  To page through all four screens, use
  354.                       either the page up or page down key.
  355.  
  356.  ALT-X              : This command allows you to exit ACIDDRAW, if the
  357.                       ACiDDraw decects that the CURRENT PAGE has been
  358.                       changed before it was saved, it will prompt you
  359.                       if you want to save it.
  360.  
  361.                                                                               
  362. ┌───────────────────┐                                                         
  363. │ Missing Functions │                                                     
  364. └───────────────────┘       
  365.  
  366.      This alpha version is missing serveral functions which keeps it from
  367. becoming a release version.  Please note these:
  368.  
  369.          ■ Cannot load a 160 column ansi, only 80 columns will be read.
  370.          ■ Will not determine the proper size for a binary file load.
  371.          ■ Ansi save with 160 column mode will only save the first 80.
  372.  
  373.  These and several more functions will be added into the final release 
  374. version of ACiDDraw.
  375.                                                                     
  376.  
  377. ┌─────────────────┐                                                           
  378. │ How to Register │                                                           
  379. └─────────────────┘                                                           
  380.                                                                               
  381.      1. Print out or duplicate order form below                               
  382.      2. Fill out the order form.                                                  
  383.      3. Mail order form along with Cheque or Money Order for $10 US or $13 CAN
  384.      4. Make all Cheques or Money Orders out to Dennis.
  385.  
  386.  
  387. ┌────────────┐
  388. │ Order Form │
  389. └────────────┘
  390.  
  391.      Name:              __________________________________                    
  392.      Address:           __________________________________                    
  393.      Apartment #:       __________________________________                    
  394.      City:              __________________________________                    
  395.      State/Prov:        __________________________________                    
  396.      Zip/Postal Code:   __________________________________                    
  397.      Country:           __________________________________                    
  398.      Voice #:           (___) ___-____                                        
  399.      Please Specify:    3½ [ ]  or  5¼ [ ]  (just one)                        
  400.                         HD [ ]  or  DD [ ]  (just one)                        
  401.                                                                               
  402.      Comments and/or Suggestions:                                             
  403.         _________________________________________________________________     
  404.         _________________________________________________________________     
  405.         _________________________________________________________________     
  406.         _________________________________________________________________     
  407.         _________________________________________________________________     
  408.         _________________________________________________________________
  409.         _________________________________________________________________
  410.  
  411.      Note:  All information will be kept confidential.
  412.  
  413.      Send order forms to:
  414.  
  415.         Once again, since this version of ACiDDraw is still in testing, there
  416. is no registration required.
  417.  
  418. ┌───────────────────┐
  419. │ Where to Reach Us │
  420. └───────────────────┘
  421.  
  422.      Comments, bug report, suggestion, etc can be forwarded to either
  423.      Sinned Soul or Skull Leader at the following locations :
  424.  
  425.      ACiD Western Agora
  426.  
  427.      Terra Firma             (714) 963-4851
  428.      Terra Firma             (714) 963-4972
  429.  
  430.      via the internet:                                                        
  431.                                                                              
  432.      aciddraw@cyberspace.net (ACiDDRAW Account)
  433.                                                                               
  434.                                                                              
  435. ┌───────────────┐                                                         
  436. │ Final Notices │                                                         
  437. └───────────────┘                                                         
  438.  
  439.     It has been decided that since this is an alpha version, there will be no
  440.     artificial limitations or registration nags.  In further, full release 
  441.     versions, registration will be required. This registration will provide
  442.     you with access to all new upgrades, and the eternal gratitude of those
  443.     who've put substantial amounts of experience, energy, and time into this
  444.     venture. Will the spa hunt you down if you do not? Most likely no, but
  445.     registration will insure that the authors remain interested in creating
  446.     good programs for you and others to use in the future.
  447. SAUCE00ACiDDraw Documentation                                 ACiD Productions    19941101┘VP┐